home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / facts32.zip / FACTS.DOC < prev    next >
Text File  |  1993-03-22  |  16KB  |  349 lines
  1.  
  2.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  3.                   Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  4.                     Remote Access, SpitFire, WWIV and others.
  5.  
  6.                                       By
  7.  
  8.                                 Richard Paquette
  9.                                    PO Box 416
  10.                               Mt. Laurel, NJ 08054
  11.  
  12.                                (C) Copyright 1990
  13.                                All Rights Reserved
  14.  
  15.                  DOOR DESCRIPTION!
  16.  
  17.    If you have ever watched Jeopardy on television, then you will have a very
  18. good idea what FACTS is all about.. when you first enter the door, the main
  19. menu allows you:
  20.  
  21.                         1. Play the GAME OF FACTS    
  22.                         2. Get Instructions/Help
  23.                         3. View Scoreboard
  24.                         4. Color On/Off
  25.                         Q. Return to BBS
  26.  
  27.    1. Play the GAME OF FACTS brings you to a full page category menu with the
  28.  categories listed across the top line. When you select a category number, it
  29.  then prompts for the amount to win which are listed vertically. After you have
  30.  selected the amount, the answer is displayed with a prompt for the question.
  31.  
  32.       You enter the question, if correct, then you score is updated with the
  33.  amount you selected, if wrong, no score is given nor is the amount taken from
  34.  your current score.
  35.  
  36.       If you play all 25 questions, you are then automatically brought to the
  37.  BONUS ROUND at which time you will be prompted to BET on the question. Your
  38.  bet can be anything from $1.00 to your TOTAL SCORE. If you win, you double
  39.  your bet and if you lose, you lose only your bet.
  40.  
  41.       You are then brought to the main menu and cannot play again unless you
  42.  exit the door and re-enter it if your time online has more than 5 minutes
  43.  left. If not.. then you won't be allowed back in.
  44.  
  45.    2. Get Instructions is similiar to these descriptions.
  46.  
  47.    3. View Scoreboard will list your name according to the highest score first
  48.  and descending from there.
  49.  
  50.    4. Color On/Off allows you to toggle your color on or off.
  51.  
  52.    5. Returns you to the BBS.
  53.  
  54.                                       FILES
  55.  
  56.            The following files are packaged with this ZIP file
  57.  
  58.  Facts.exe   <--- executable program must be in directory at all times
  59.  Facts.cfg   <--- sample configuration file, must have one for each node
  60.  Categor.eis <--- this file contains names of the categories in the directory
  61.  science.dat <--- one question and answer file, must be in directory
  62.  flowers.dat <--- another question and answer file, must be in directory
  63.  cities.dat  <--- another question and answer file, must be in directory
  64.  capital.dat <--- another question and answer file, must be in directory
  65.  movies.dat  <--- another question and answer file, must be in directory
  66.  facts.usr   <--- created by program and MUST NOT BE DELETED
  67.                   (this maintains the players names and scores)
  68.  order.frm   <--- Order form for all Livewire Doors
  69.  facts.log   <--- Will create if not present.. tracks callers in door
  70.  
  71.  Categor.eis contains all the current categories in your directory that are
  72. randomly selected and place in the game.. the more you have the better it is.
  73.  
  74.  Each time someone opens the door, there will be different categories to get
  75. selected and the program takes care of all the work for you. Please read the
  76. important note to find out more...
  77.  
  78.   IMPORTANT NOTE:
  79.  
  80.   When this door is registered, you may download other *.dat files and add them
  81. to your categor.eis file with the facts utility now being finished. Each of the
  82. *.dat files has 50 questions and the questions are randomly selected so that
  83. 90% of the time, the same question will not appear twice in the same category
  84. within the 5 dollar amounts.
  85.   
  86.   Of course by registrating this door, you will have access to all the new
  87. *.dat files being created and you will recieve an editor to add questions to
  88. the existing *.dat files and also add new categories along with editing the
  89. facts.usr file.
  90.  
  91.   The Editor and other dat files are downloadable from The Livewire BBS, home
  92. of FACTS.ZIP plus many other fine door products.
  93.  
  94.   Other files already to go include subjects such as: 
  95.  
  96.   History, General, Flowers, Trees, Capitals, Cities, Trekie, Science plus many
  97. more under construction, the initial file contains only 50 questions which you
  98. can add to with your facts editing program.
  99.  
  100.   Please be sure to register as soon as possible.. will ease your conscious and
  101. allow you to have unlimited categories.
  102.  
  103.  
  104. CONFIGURATION
  105. -------------
  106.  
  107.   The registration number goes on line number 5 
  108.   The option to reveal answers goes on line number 6              Y=yes N=no
  109.   The option to create a log file (facts.log) on line number 7    Y=yes N=no
  110.  
  111.   NOTE: Leaving the lines (5-6-7) blank WILL create an error... 
  112.  
  113.   The following are just samples for different softwares...
  114.  
  115.                   Example configuration file for PCBOARD.SYS
  116.                   ------------------------------------------
  117.                                                                              
  118. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  119. The Livewire BBS    <=-  (Change this to your BBS name)
  120. Richard             <=-  (The Sysop's first name)
  121. Paquette            <=-  (The Sysop's last name)
  122.  
  123. Example configuration file for USERS.SYS
  124. ------------------------------------------
  125.                                                                              
  126. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  127. The Livewire BBS    <=-  (Change this to your BBS name)
  128. Richard             <=-  (The Sysop's first name)
  129. Paquette            <=-  (The Sysop's last name)
  130.  
  131. Example configuration file for DOOR.SYS
  132. ---------------------------------------
  133.                                                                              
  134. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  135. The Livewire BBS    <=-  (Change this to your BBS name)
  136. Richard             <=-  (The Sysop's first name)
  137. Paquette            <=-  (The Sysop's last name)
  138.  
  139. Example configuration file for USERINFO.DAT
  140. -------------------------------------------
  141.                                                                              
  142. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  143. The Livewire BBS    <=-  (Change this to your BBS name)
  144. Richard             <=-  (The Sysop's first name)
  145. Paquette            <=-  (The Sysop's last name)
  146. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  147.  
  148. Example configuration file for CALLINFO.BBS
  149. -------------------------------------------
  150.                                                                              
  151. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  152. The Livewire BBS    <=-  (Change this to your BBS name)
  153. Richard             <=-  (The Sysop's first name)
  154. Paquette            <=-  (The Sysop's last name)
  155.  
  156. Example configuration file for DORINFOx.DEF
  157. -------------------------------------------
  158.                                                                              
  159. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  160.                           where 'x' is the BBS Node number.
  161. The Livewire BBS    <=-  (Change this to your BBS name)
  162. Richard             <=-  (The Sysop's first name)
  163. Paquette            <=-  (The Sysop's last name)
  164.  
  165. Example configuration file for SFDOORS.DAT
  166. ------------------------------------------
  167.                                                                              
  168. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  169. The Livewire BBS    <=-  (Change this to your BBS name)
  170. Richard             <=-  (The Sysop's first name)
  171. Paquette            <=-  (The Sysop's last name)
  172.  
  173. Example configuration file for CHAIN.TXT
  174. ----------------------------------------
  175.                                                                              
  176. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  177. The Livewire BBS    <=-  (Change this to your BBS name)
  178. Richard             <=-  (The Sysop's first name)
  179. Paquette            <=-  (The Sysop's last name)
  180.  
  181. Example configuration file for GTUSER.BBS
  182. ----------------------------------------
  183.                                                                              
  184. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  185. The Livewire BBS    <=-  (Change this to your BBS name)
  186. Richard             <=-  (The Sysop's first name)
  187. Paquette            <=-  (The Sysop's last name)
  188. 1                   <=-  (COM port number - defaults to 1)
  189. 1                   <=-  (Node number - defaults to 1)
  190. 123123              <=-  (Registration Number)
  191.  
  192. Example configuration file for TRIBBS.SYS
  193. ----------------------------------------
  194.                                                                              
  195. C:\BBS\TRIBBS.SYS   <=-  (Full pathname of your TRIBBS.SYS file)
  196. The Livewire BBS    <=-  (Change this to your BBS name)
  197. Richard             <=-  (The Sysop's first name)
  198. Paquette            <=-  (The Sysop's last name)
  199.  
  200.                                  ==============
  201.  
  202.                                    BATCH FILE
  203.  
  204. This is the batch file whose name is entered in PCBSETUP. It should reside in
  205. your default PCB directory. Leave this as is except for changing the paths.
  206.  
  207.           ECHO OFF
  208.           E:\
  209.           CD\FACTS
  210.           FACTS FACTS.CFG  <--- Please read NOTE below
  211.           C:\
  212.           CD\PCB
  213.           BOARD
  214.  
  215. NOTE FOR FOSSIL DRIVER USERS:
  216.  
  217.   Facts now includes support for FOSSIL drivers!!! This means your Doors
  218.  will work with Digiboard (e.g. Wildcat!'s M version) and other multi-port
  219.  boards. To activate the Fossil driver support, just include /FD on the
  220.  command line when running the Door. For example:
  221.  
  222.       FACTS FACTS.CFG /FD
  223.  
  224.  If no Fossil driver is available, Facts will display a message to that
  225.  effect and exit gracefully.
  226.  
  227. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  228.  
  229.                   Supports COM 1 to 4 on the standard IRQ's
  230.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  231.  
  232.                You can make use of the IRQ environment variable
  233.  
  234.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  235. configuration filename. For example the program is STORE and you want to use 
  236. Com1 and IRQ5. The command line passed to your door would be:
  237.  
  238.                             STORE STORE.CFG /5 
  239.                                    or
  240.              STORE STORE.CFG /%IRQ% using the environment variable
  241.  
  242.     The /5 tells STORE to use IRQ5 rather than the standard IRQ4 that is
  243. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  244.  
  245.    You can also make use of the PCBoard environment variables such as:
  246.  PCBDRIVE and PCBDIR. Or you can use your own for example, let's say that
  247.  your system runs on D: drive and your system directory is call GAP then
  248.  you could use the variables at the start of your batch file such as:
  249.  
  250.    d:\
  251.    cd\doors\facts
  252.    set pcbdrive=d:
  253.    set pcbdir=\gap
  254.    facts facts.cfg
  255.    set pcbdrive =
  256.    set pcbdir =
  257.    d:\
  258.    cd\gap
  259.    gap
  260.  
  261.  Then the first line in your cfg would look like this:
  262.  
  263.                         %PCBDRIVE%%PCBDIR\dorinfo.def
  264.  
  265.                               Sysop Keys
  266.                               ----------
  267.  
  268. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  269.          written to DOOR.SYS and USERS.SYS
  270. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  271.          and/or written to DOOR.SYS and USERS.SYS
  272. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  273. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  274.          and/or written to DOOR.SYS and USERS.SYS
  275. F8    -  Returns the caller involuntarily to the BBS.
  276. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  277.          and/or written to DOOR.SYS and USERS.SYS
  278. F10   -  Activates SysOp CHAT mode within the DOOR.
  279. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  280. UP    -  Give the caller extra time while in the DOOR.  
  281. DN    -  Subtract time from the caller while in the DOOR. 
  282. HOME  -  HELP key for Status Line options.
  283. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  284. ALT-X -  PCBoard will exit after current caller logs off. Value is
  285.          passed to PCBoard. Not available on non-PCBoard systems.
  286.  
  287.                             WATCHDOG/CTTY/ANSI.SYS
  288.                             ----------------------
  289.  
  290.         CTTY and WATCHDOG are not required and should not be used with
  291.         this program.  FACTS contains its own communication routines
  292.         which monitor the COM port.  If carrier is lost, it will return
  293.         to PCBoard where the BBS will log the user off the system.
  294.         ANSI.SYS, or something similar, is required for FACTS to
  295.         function properly!
  296.  
  297.                                  DISTRIBUTION
  298.                                  ------------
  299.  
  300.         FACTS is COPYRIGHTED by Richard Paquette, with all rights reserved.
  301.         This program is being distributed via the SHAREWARE concept and as
  302.         such, may be copied freely with the following restrictions:
  303.  
  304.                 * The program must be supplied in it's original
  305.                   unmodified form, including documentation.
  306.  
  307.                 * FACTS may not be distributed as part of any
  308.                   commercial application or service without the
  309.                   express, written consent of the author.
  310.  
  311.                 * Vendors of Shareware/Public Domain software may
  312.                   not distribute this program without the express,
  313.                   written consent of the author.
  314.  
  315.                                  REGISTRATION
  316.                                  ------------
  317.  
  318.         FACTS represents many hours of programming and the author
  319.         deserves just compensation for his time, efforts and expertise.
  320.         If you find this program to be of some value and you continue
  321.         to use it on your BBS system, you must return the registration
  322.         form provided along with the registration fee. Registration
  323.         entitles you to free upgrades via modem from The Livewire's Support
  324.  
  325.         Additional upgrades/support to the BBS are available at $35.00 per
  326.         year. Payments should be made in the form of a check or money order
  327.         (do NOT send cash!). Foreign orders must be in U.S. funds drawn on a
  328.         U.S. bank.
  329.  
  330.            **********           REGISTER ONLINE          ***********
  331.  
  332.         You may also call The Livewire BBS and register online via
  333.         Visa or Mastercard using our online Credit Card door which will 
  334.         produce your registration number on the spot! At the main board
  335.         prompt just type  REGISTER  and presto.. 
  336.  
  337.         Suggestions and/or comments may be sent to the address below or
  338.         via electronic mail: 
  339.  
  340.                                 Richard Paquette
  341.                                 The Livewire BBS     
  342.                            NET-HUB for RealLife(tm) Net
  343.                            InterNet: Livewire@bbscd.com
  344.                        FidoNet 1:266/36 PoliceNet 150:360/29
  345.  
  346.                       Public Access Node1: (609) 235-5297 HST
  347.           Free Access to Private Nodes after registering a door program.
  348.                             ----------------------
  349.